Display one image frame.
int MV_CC_DisplayOneFrame( void *handle, MV_DISPLAY_FRAME_INFO *pDisplayInfo );
[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.
[IN] Image information, see the structure MV_DISPLAY_FRAME_INFO for details.
Return MV_OK(0) on success, and return Error Code on failure.
This API is valid for USB3Vision camera and GIGE camera.
This API is not supported by CameraLink device.
The following sample code is for reference only.
#include "MvCameraControl.h"
void main()
{
int nRet = -1;
void* m_handle = NULL;
//Enumerate all devices corresponding to specified transport protocol within subnet
unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
int nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
if (MV_OK != nRet)
{
printf("error: EnumDevices fail [%x]\n", nRet);
return;
}
int i = 0;
if (m_stDevList.nDeviceNum == 0)
{
printf("no camera found!\n");
return;
}
//Select the first found online device and create device handle
int nDeviceIndex = 0;
MV_CC_DEVICE_INFO m_stDevInfo = {0};
memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));
nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);
if (MV_OK != nRet)
{
printf("error: CreateHandle fail [%x]\n", nRet);
return;
}
//Connect to device
nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
if (MV_OK != nRet)
{
printf("error: OpenDevice fail [%x]\n", nRet);
return;
}
//...other processing
//Start acquiring image
nRet = MV_CC_StartGrabbing(m_handle);
if (MV_OK != nRet)
{
printf("error: StartGrabbing fail [%x]\n", nRet);
return;
}
MV_FRAME_OUT stOutFrame;
memset(&stOutFrame, 0, sizeof(MV_FRAME_OUT));
MV_DISPLAY_FRAME_INFO stDisplayOneFrame;
memset(&stDisplayOneFrame, 0, sizeof(MV_DISPLAY_FRAME_INFO));
//The frequency of calling this API should be controlled by upper layer application according to frame rate
//The codes are for reference only. In practical application, it is recommended to create a new thread for image acquisition and processing.
while(1)
{
if (nTestFrameSize > 99)
{
break;
}
nRet = MV_CC_GetImageBuffer(m_handle, &stOutFrame, 1000);
if (MV_OK != nRet)
{
Sleep(10);
}
else
{
//...Process image data
nTestFrameSize++;
}
stDisplayOneFrame.hWnd = hWnd; stDisplayOneFrame.pData = stFrameOut.pData; stDisplayOneFrame.nDataLen = stFrameOut.stFrameInfo.nFrameLen; stDisplayOneFrame.nWidth = stFrameOut.stFrameInfo.nWidth; stDisplayOneFrame.nHeight = stFrameOut.stFrameInfo.nHeight; stDisplayOneFrame.enPixelType = stFrameOut.stFrameInfo.enPixelType;
nRet = MV_CC_DisplayOneFrame(m_handle, &stDisplayOneFrame);
if(nRet != MV_OK) { printf("Display one frame fail! nRet [0x%x]\n", nRet);
}
nRet = MV_CC_FreeImageBuffer(m_handle, &stOutFrame);
if(nRet != MV_OK) { printf("Free Image Buffer fail! nRet [0x%x]\n", nRet);
}
}
//...other processing
//Stop acquiring image
nRet = MV_CC_StopGrabbing(m_handle);
if (MV_OK != nRet)
{
printf("error: StopGrabbing fail [%x]\n", nRet);
return;
}
//Shut down device and release resource
nRet = MV_CC_CloseDevice(m_handle);
if (MV_OK != nRet)
{
printf("error: CloseDevice fail [%x]\n", nRet);
return;
}
//Destroy handle and release resource
nRet = MV_CC_DestroyHandle(m_handle);
if (MV_OK != nRet)
{
printf("error: DestroyHandle fail [%x]\n", nRet);
return;
}
}
Display one image frame.
int MV_CC_DisplayOneFrame( void *handle, MV_DISPLAY_FRAME_INFO *pDisplayInfo );
[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.
[IN] Image information, see the structure MV_DISPLAY_FRAME_INFO for details.
Return MV_OK(0) on success, and return Error Code on failure.
This API is valid for USB3Vision camera and GIGE camera.
This API is not supported by CameraLink device.
The following sample code is for reference only.
#include "MvCameraControl.h"
void main()
{
int nRet = -1;
void* m_handle = NULL;
//Enumerate all devices corresponding to specified transport protocol within subnet
unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
int nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
if (MV_OK != nRet)
{
printf("error: EnumDevices fail [%x]\n", nRet);
return;
}
int i = 0;
if (m_stDevList.nDeviceNum == 0)
{
printf("no camera found!\n");
return;
}
//Select the first found online device and create device handle
int nDeviceIndex = 0;
MV_CC_DEVICE_INFO m_stDevInfo = {0};
memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));
nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);
if (MV_OK != nRet)
{
printf("error: CreateHandle fail [%x]\n", nRet);
return;
}
//Connect to device
nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
if (MV_OK != nRet)
{
printf("error: OpenDevice fail [%x]\n", nRet);
return;
}
//...other processing
//Start acquiring image
nRet = MV_CC_StartGrabbing(m_handle);
if (MV_OK != nRet)
{
printf("error: StartGrabbing fail [%x]\n", nRet);
return;
}
MV_FRAME_OUT stOutFrame;
memset(&stOutFrame, 0, sizeof(MV_FRAME_OUT));
MV_DISPLAY_FRAME_INFO stDisplayOneFrame;
memset(&stDisplayOneFrame, 0, sizeof(MV_DISPLAY_FRAME_INFO));
//The frequency of calling this API should be controlled by upper layer application according to frame rate
//The codes are for reference only. In practical application, it is recommended to create a new thread for image acquisition and processing.
while(1)
{
if (nTestFrameSize > 99)
{
break;
}
nRet = MV_CC_GetImageBuffer(m_handle, &stOutFrame, 1000);
if (MV_OK != nRet)
{
Sleep(10);
}
else
{
//...Process image data
nTestFrameSize++;
}
stDisplayOneFrame.hWnd = hWnd; stDisplayOneFrame.pData = stFrameOut.pData; stDisplayOneFrame.nDataLen = stFrameOut.stFrameInfo.nFrameLen; stDisplayOneFrame.nWidth = stFrameOut.stFrameInfo.nWidth; stDisplayOneFrame.nHeight = stFrameOut.stFrameInfo.nHeight; stDisplayOneFrame.enPixelType = stFrameOut.stFrameInfo.enPixelType;
nRet = MV_CC_DisplayOneFrame(m_handle, &stDisplayOneFrame);
if(nRet != MV_OK) { printf("Display one frame fail! nRet [0x%x]\n", nRet);
}
nRet = MV_CC_FreeImageBuffer(m_handle, &stOutFrame);
if(nRet != MV_OK) { printf("Free Image Buffer fail! nRet [0x%x]\n", nRet);
}
}
//...other processing
//Stop acquiring image
nRet = MV_CC_StopGrabbing(m_handle);
if (MV_OK != nRet)
{
printf("error: StopGrabbing fail [%x]\n", nRet);
return;
}
//Shut down device and release resource
nRet = MV_CC_CloseDevice(m_handle);
if (MV_OK != nRet)
{
printf("error: CloseDevice fail [%x]\n", nRet);
return;
}
//Destroy handle and release resource
nRet = MV_CC_DestroyHandle(m_handle);
if (MV_OK != nRet)
{
printf("error: DestroyHandle fail [%x]\n", nRet);
return;
}
}